package com.example.demo.mapper;

import com.example.demo.entity.Tag;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 标签数据访问层接口
 * 负责标签相关的数据库操作
 */
@Mapper
public interface TagMapper {
    
    /**
     * 根据ID查询标签
     * @param id 标签ID
     * @return 标签信息
     */
    Tag selectById(@Param("id") Long id);
    
    /**
     * 根据名称查询标签
     * @param name 标签名称
     * @return 标签信息
     */
    Tag selectByName(@Param("name") String name);
    
    /**
     * 查询所有标签列表
     * @return 标签列表
     */
    List<Tag> selectAllTags();
    
    /**
     * 查询热门标签列表（按使用次数排序）
     * @param limit 数量限制
     * @return 热门标签列表
     */
    List<Tag> selectPopularTags(@Param("limit") int limit);
    
    /**
     * 根据名称列表批量查询标签
     * @param names 标签名称列表
     * @return 标签列表
     */
    List<Tag> selectTagsByNames(@Param("names") List<String> names);
    
    /**
     * 插入标签
     * @param tag 标签信息
     * @return 影响的行数
     */
    int insert(Tag tag);
    
    /**
     * 更新标签
     * @param tag 标签信息
     * @return 影响的行数
     */
    int update(Tag tag);
    
    /**
     * 更新标签使用次数
     * @param id 标签ID
     * @param increment 增加数量（可以为负数，表示减少）
     * @return 影响的行数
     */
    int updateArticleCount(@Param("id") Long id, @Param("increment") int increment);
    
    /**
     * 根据ID删除标签
     * @param id 标签ID
     * @return 影响的行数
     */
    int deleteById(@Param("id") Long id);
    
    /**
     * 查询标签总数
     * @return 标签总数
     */
    long selectTotalCount();
}
